Skills 架构分析

skills/                                  # 根目录（56个技能）
├── AGENTS.md                            # 仓库级代理指引（创建技能规范）
├── README.md                            # 技能索引表（名称 + 描述 + 链接）
├── LICENSE
└── skills/
    └── {skill-name}/                    # 单个技能，kebab-case 命名
        ├── SKILL.md                     # ★ 必需：YAML前言 + 极简主体
        ├── references/                  # ★ 必需：详细参考文档
        │   ├── checklist.md             # 动词型/best-practice 均需
        │   ├── standard.md              # 仅 best-practice 需要（规范定义）
        │   ├── workflow.md              # 可选：顺序/条件工作流
        │   ├── philosophy.md            # 可选：设计哲学
        │   └── examples/                # 可选：示例文件目录
        ├── best-practice-examples/      # ★ 仅 best-practice：正例代码
        ├── scripts/                     # 可选：可执行脚本 (.ts/.py/.sh)
        └── assets/                      # 可选：静态资源（图片等）

技能名称
├── 以 -best-practice 结尾？
│   └── YES → best-practice 型（Must follow when）
│       所需：references/checklist.md + references/standard.md + best-practice-examples/
│       示例：dao-best-practice、component-unit-best-practice、skill-best-practice
│
└── NO → 动词型（Use when）
    ├── check-*   → 检查/验证类：检查代码是否符合某规范
    │   示例：check-checklist、check-components、check-props-drilling
    ├── implement-* → 实现/执行类：按规范完成某项工作
    │   示例：implement-feature、implement-split、implement-trpc-query
    ├── integrate-* → 集成/接入类：将外部库集成到项目
    │   示例：integrate-better-auth、integrate-zod-env
    ├── refactor-* → 重构/转换类：将代码从一种形式转为另一种
    │   示例：refactor-classname、refactor-ui-components
    ├── create-* / generate-* → 创建/生成类
    │   示例：create-skill、generate-preview
    └── 其他动词 → 工作流/流程类
        示例：brainstorming、writing-plans、subagent-driven-development

┌─────────────────────────────────────────────┐
│ 第1级：description 前缀（始终可见）          │
│  "Must follow when" → 上下文匹配自动触发      │
│  "Use when"        → 用户提示词匹配触发       │
├─────────────────────────────────────────────┤
│ 第2级：触发词（description 内声明）          │
│  "触发词：检查checklist规范、checklist审查"   │
└─────────────────────────────────────────────┘

brainstorming ──→ writing-plans ──→ subagent-driven-development
                                      │
                                      └── test-driven-development (每个任务)

始终加载：  YAML frontmatter (name + description)
触发加载：  SKILL.md 主体（~20行）
按需加载：  references/ 文件（checklist.md、standard.md、workflow.md）
不加载：    scripts/、assets/（通过命令行调用，不占上下文）

┌──────────────────────────────────────────────────────┐
│  上下文预算分配                                       │
│  ┌──────────────┐  ┌──────────┐  ┌────────────────┐  │
│  │ frontmatter   │  │ body     │  │ references     │  │
│  │ ~150 chars    │  │ ≤20行    │  │ 按需加载        │  │
│  │ 始终在上下文中 │  │ 触发后加载│  │ 用完即释放      │  │
│  └──────────────┘  └──────────┘  └────────────────┘  │
└──────────────────────────────────────────────────────┘

正则：^[a-z0-9]+(-[a-z0-9]+)*$
长度：≤ 64 字符

设计阶段：    brainstorming ──→ writing-plans
实现阶段：    subagent-driven-development ──→ test-driven-development
质量阶段：    check-all-best-practices ──→ fix-all-best-practices

                    ┌──────────────────────┐
                    │     SKILL.md          │
                    │  name + description   │  ← 始终在上下文
                    │  (YAML frontmatter)   │
                    ├──────────────────────┤
                    │  使用说明（≤20行）     │  ← 触发后加载
                    │  1. 读取 references/A  │
                    │  2. 对照 checklist.md  │
                    │  3. 输出/执行          │
                    └──┬──────┬──────┬─────┘
                       │      │      │
              ┌────────▼┐ ┌──▼───┐ ┌▼────────┐
              │standard │ │check │ │workflow  │  ← 按需加载
              │.md      │ │list  │ │.md       │
              │(规范定义)│ │.md   │ │(流程步骤)│
              └─────────┘ └──────┘ └──────────┘